home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1999 May / Macworld (1999-05).dmg / MkLinux-DR3 / Read Me files / README next >
Text File  |  1998-12-12  |  12KB  |  275 lines
  1. July 31, 1998
  2.  
  3. Welcome to MkLinux Developer Release 3 (DR3) FTP archive.
  4.  
  5. If you're not familiar with MkLinux, please see the web site:
  6.     http://www.mklinux.apple.com/
  7.  
  8. The easiest way to install MkLinux is using the MkLinux DR3 CD-ROM.  Please
  9. see the web page or the DR3 announcement for details on obtaining the CD.
  10. In most cases, it is possible to install MkLinux DR3 from this FTP archive.
  11. If that's what you want to do, continue reading!
  12.  
  13. We've duplicated the CD's directory structure in this FTP archive.  However,
  14. there are a few differences, which are outlined below.
  15.  
  16. What's on the CD
  17. ----------------
  18.  
  19. The DR3 CD contains the following files or folders at the top level:
  20.  
  21.     README             - Mac and Unix versions, containing identical text
  22.     MacOS Utilities/   - Three partitioning programs that run under MacOS
  23.     Mac Files/         - The pieces of MkLinux that reside in your MacOS volume
  24.     mach_servers/      - The pieces needed to boot the MkLinux installer
  25.     RedHat/...         - Many packages that can be installed as part of DR3
  26.     SRPMS/             - Sources to the above DR3 packages
  27.     extra/...          - More packages that can be installed later
  28.     mklinux_source/    - Sources to MkLinux's Mach microkernel and Linux server
  29.     misc_source/       - Other sources that may be of interest
  30.  
  31. What's different here
  32. ---------------------
  33.  
  34. There is an extensive README file on the CD, which has been renamed
  35. "README_DR3" in this FTP archive.  You should read it, as almost all of it is
  36. applicable to you.  The "README" that you're looking at right now describes
  37. only the additional information that you need to install MkLinux from this FTP
  38. archive.
  39.  
  40. The file "Announcement" contains the announcement for MkLinux DR3.
  41.  
  42. The folders "MacOS Utilities", "Mac Files", and "mach_servers" are recreated
  43. here in two forms.  Each folder has been bundled into a self-extracting
  44. archive.  If you are downloading these pieces for the first time, we suggest
  45. that you simply retrieve the three "sea.hqx" files.  If you're looking for just
  46. one or two files from one of those folders, then you can look in the similarly
  47. named directory here.  (If you do this with files in "mach_servers", be sure
  48. to FTP them in _binary_ mode, even "bootstrap.conf", even though it looks like
  49. a text file!)
  50.  
  51. There are a few RPMs and SRPMs that are available here, in the "extra"
  52. directory that do not exist on the CD.  These files were left off the CD
  53. because they were either too large to fit on the CD, or simply not required
  54. for DR3.  They are:
  55.  
  56.     extra/RPMS/howto-translations-5.0-5a.noarch.rpm
  57.     extra/SRPMS/howto-5.0-5a.src.rpm
  58.     extra/SRPMS/X11R6.3-01-1r.src.rpm
  59.  
  60.     extra/RPMS/emacs-19.34-1B.ppc.rpm
  61.     extra/RPMS/emacs-X11-19.34-1B.ppc.rpm
  62.     extra/RPMS/emacs-el-19.34-1B.ppc.rpm
  63.     extra/RPMS/emacs-nox-19.34-1B.ppc.rpm
  64.     extra/SRPMS/emacs-19.34-1B.src.rpm
  65.  
  66.     extra/RPMS/gcc-2.8.0-1c.ppc.rpm
  67.     extra/SRPMS/gcc-2.8.0-1c.src.rpm
  68.     
  69.     The howto-translations and the howto SRPM are huge, as is the X SRPM.
  70.     They were left off the CD so that everything else would fit.
  71.  
  72.     The emacs-19.34 is a slightly older version than the official DR3 version
  73.     (emacs-20.2).  We've left it on the FTP site in "extra" because there are
  74.     a few things that don't work right in the newer emacs.  Some zealous
  75.     emacs users will want to stick with the older 19.34 version for now.
  76.  
  77.     EGCS (Experimental GNU Complier System) is the official compiler for DR3.
  78.     These days, most of the Open Source PowerPC compiler development is
  79.     occuring on the "egcs" package.  gcc-2.8, which has some problems, is
  80.     provided via FTP only.
  81.  
  82. Installing DR3 using files from the FTP archive
  83. -----------------------------------------------
  84.  
  85. 1) Read the file "README_DR3" in this directory.
  86.  
  87. 2) Use the programs in MacOS_Utilities to partition your disk for MkLinux.
  88.    If you don't know how to do this, go back to step 1.
  89.  
  90. 3) Put the "Mac Files" into your MacOS system volume according to the
  91.    instructions in README_DR3.  For now, ignore the part about SCSI vs. ATAPI
  92.    CD-ROM drives and editing lilo.conf's rootdev line.  Yes, you will need to
  93.    edit the rootdev line; we'll get to that later.
  94.  
  95. 4) Place the "mach_servers" folder at the top level (ie. not on the desktop)
  96.    of a suitable volume on your Mac.  For MkLinux to be able to access your
  97.    mach_servers folder, the volume containing it must be:
  98.       a) on an HFS (MacOS Standard) volume, not HFS+ (MacOS Extended)
  99.       b) on a drive that MkLinux can recognize.  Right now, MkLinux does not
  100.          recognize any drives attached to PCI SCSI adapters.  Also, the DR3
  101.          kernel is known to have some difficulty with some IDE drives.  If you
  102.          get the infamous "bootstrap cannot find config file" message, then
  103.          you may need to use a SCSI device to hold your mach_servers folder.
  104.  
  105.    Once you completed the MkLinux installation, you will not need this
  106.    mach_servers folder anymore.
  107.  
  108. 5) Determine the MkLinux device name for the partition where you finally ended
  109.    up putting your mach_servers folder.  Typical device names look something
  110.    like this:
  111.  
  112.     /dev/hda4    (fourth partition on the first IDE drive)
  113.         /dev/sda5    (fifth partition on the first SCSI drive)
  114.         /dev/sdb7    (seventh partition on the second SCSI drive)
  115.  
  116.    The pdisk utility is probably the best tool to determine the device names
  117.    for your MacOS partitions.  Use the "L" command to display the partition
  118.    tables for every drive attached to your Mac.  It may take some sleuthing,
  119.    but you should be able to figure out the partition which contains the
  120.    HFS volume containing the mach_servers folder.  Here's an example of pdisk
  121.    output:
  122.  
  123.      Partition map (with 512 byte blocks) on '/dev/sda'
  124.       #:                type name             length   base    ( size )
  125.       1: Apple_partition_map Apple                63 @ 1      
  126.       2:      Apple_Driver43*Macintosh            54 @ 64     
  127.       3:      Apple_Driver43*Macintosh            74 @ 118    
  128.       4:       Apple_Patches Patch Partition     512 @ 192    
  129.       5:           Apple_HFS untitled         614400 @ 704     (300.0M)
  130.       6:     Apple_UNIX_SVR2 swap             196608 @ 615104  ( 96.0M)
  131.       7:     Apple_UNIX_SVR2 root            3381703 @ 811712  (  1.6G)
  132.       
  133.    In this case, the device name for the MacOS partition is '/dev/sda5'.
  134.  
  135. 6) Put that device name into your lilo.conf file's rootdev line.  You do this
  136.    by invoking the MkLinux control panel.  Click on the "Custom" button.
  137.    SimpleText will launch and you'll be editing a preferences file called
  138.    "lilo.conf".  Edit the "rootdev=" line so that it points to the partition
  139.    containing your mach_servers.
  140.  
  141. 7) Reboot, when the MkLinux "Splash Screen" comes up, select MkLinux.  After
  142.    a few moments of booting messages, you should be in the MkLinux Installer.
  143.  
  144. 8) In general, you will follow the installer screens according to the
  145.    instructions given in README_DR3.  However, once you get to Installation
  146.    Method, you'll need to pick something other than "Local CDROM".
  147.  
  148.    The installer needs to be able to access the RPMs and other files that are
  149.    in the "RedHat" directory (under DR3 on this FTP site).  If you are
  150.    connected to the internet via the ethernet port on your Mac, you can
  151.    retrieve the RPM's via FTP as they are needed (ie. you don't need to
  152.    download them all beforehand).
  153.  
  154.    If you choose the FTP install, you'll need to know the name of an FTP
  155.    site and the name of the directory that contains the RedHat directory.
  156.    On ftp.mklinux.apple.com, that directory would be "/pub/DR3", because
  157.    that's where the RedHat directory is.
  158.  
  159.    Another thing you need to know is that sometimes the installer cannot
  160.    determine the address of the FTP site if its name is a "DNS alias".
  161.    For instance, the installer won't recognize "ftp.mklinux.apple.com"
  162.    because that's really an alias for "www.mklinux.apple.com".  As a last
  163.    resort, you could always use the actual IP address (ww.xx.yy.zz) of the
  164.    ftp site.
  165.  
  166.    And one more tidbit about FTP installs: the main MkLinux FTP site,
  167.    ftp.mklinux.apple.com (or really, www.mklinux.apple.com) is usually under
  168.    heavy load.  If you try to do a FTP install directly from it, the install
  169.    process may fail and you'll have to start over.  You'll be much better off
  170.    if you choose a Mirror site.  The Mirror site list is shown when you
  171.    connect to ftp.mklinux.apple.com, and is also contained in the file
  172.    "Mirrors" at the top level (/pub) of the FTP archive.
  173.    
  174.    As an alternative to the FTP install, you can load all the RPMs onto a
  175.    local disk.  The structure of the RedHat directory must be preserved,
  176.    including the directory (or Folder) "RedHat" itself.  Some of the files
  177.    in the RedHat folder have names longer than 32 characters, and their names
  178.    will be truncated when placed onto a MacOS volume.  Don't worry about this;
  179.    the installer knows that if the files are coming from a local disk, it may
  180.    have to look for truncated names.
  181.  
  182. 9) Continue in the installer according to README_DR3.
  183.  
  184.    When you have completed the installation, you may remove the "mach_servers"
  185.    folder.
  186.  
  187.  
  188. Closing words
  189. -------------
  190.  
  191. If you have difficulties, be sure to check the Frequently Asked Questions (FAQ)
  192. on the MkLinux web site, http://www.mklinux.apple.com/
  193.  
  194. Good Luck,
  195. The MkLinux Team
  196.  
  197. ------------------------------------------------------------------------------
  198. MkLinux device naming primer:
  199.  
  200. Here's how drives are named under MkLinux, for any release since Nov 26, 1997,
  201. including many of the "wips" on the ftp site, as well this pre-DR3, DR3 final,
  202. and all versions going forward.
  203.  
  204. SCSI Drives:
  205.  
  206. MkLinux scans your SCSI busses counting from ID#0 through ID#6.  It scans
  207. the internal bus first, then the "internal/external" bus.  Any disks that
  208. are found are assigned the names "sda", "sdb", "sdc", REGARDLESS of their
  209. SCSI ID.  So, if you don't have a drive at ID#0, but you do have one at
  210. ID#1 on the internal bus, then that drive will be "/dev/sda".  This is
  211. different from earlier MkLinuxes.  SCSI CDROMs are also labeled as they
  212. are found in the scan, starting with "scd0".  So, here's a gnarly example:
  213.  
  214. Internal
  215. ID      What            type            disks           cdroms
  216. 0       (empty)
  217. 1       SCSI Disk       Hard Disk       /dev/sda
  218. 2       (empty)
  219. 3       cdrom           CDROM                           /dev/scd0
  220. 4       zip drive       Hard Disk       /dev/sdb
  221. 5       SCSI Disk       Hard Disk       /dev/sdc
  222. 6       (empty)
  223. External:
  224. 0       (empty)
  225. 1       (empty)
  226. 2       SCSI Disk       Hard Disk       /dev/sdd
  227. 3       (empty)
  228. 4       Another CDROM   CDROM                           /dev/scd1
  229. 5       jaz drive       Hard Disk       /dev/sde
  230. 6       (empty)
  231.                                            ^                ^
  232.                                            |                |   
  233.         See how the names increase         |                |
  234.         consecutively in these two --------+----------------+
  235.         columns?
  236.  
  237. ATA and ATAPI drives:
  238.  
  239. ATA naming is quite different from SCSI naming.
  240.  
  241. Your IDE drives and ATAPI CDROMs are numbered like so:
  242. On the first ATA bus, you have /dev/hda and /dev/hdb.  On the second ATA
  243. bus, you have /dev/hdc and /dev/hdd.  Etc.
  244.  
  245. Example:
  246. On the PowerMac 4400, the first ATA bus has the hard disk, and the second
  247. ATA bus has the CDROM:
  248.  
  249. First ATA bus:
  250. Master  IDE Drive       /dev/hda
  251. Slave   (empty)         /dev/hdb
  252.  
  253. Second ATA bus:
  254. Master  CDROM           /dev/hdc
  255. Slave   (empty)         /dev/hdd
  256.  
  257.                            ^
  258.                            |
  259.                            + These names fixed to the assigned positions
  260.                              even if there's an "empty" position.
  261.  
  262. Partitions:
  263. Once you have determined what MkLinux calls the drive, the partition number
  264. on that drive is specified by appending a number.
  265.  
  266. Examples:
  267.  
  268. /dev/hda5        (partition #5 on hda)
  269. /dev/sdd4        (partition #4 on sdd)
  270.  
  271. The best way I know to look at a partition map is to use the pdisk utility.
  272. It's not pretty to look at, but it really tells you what's going on with the
  273. drives in your system.  Pdisk is in the "MacOS_Utilities" directory on
  274. this ftp site.
  275.